This chapter describes each of the assembler options. In each case the default show is only used if the option is not specified in any option file, including the product defaults option file, x390.ini.
Note: This option is not available when the assembler is run under Windows 3.1.
LINEWIDTH(CR), LINEWIDTH(LF), and LINEWIDTH(NL) specify that the assembly listing is to be created in ASCII with the specified line delimiters. CR specifies that the line delimiter is the carriage return character (X'0D') as is normal for APPLE systems. LF specifies the delimiter as the line feed character (X'0A') as is normal for UNIX systems. NL specifies that both the carriage return and line feed characters will be used to terminate lines as is normal for most personal computers. These ASCII options must only be used with PRINTCTL(ASA), PRINTCTL(NL), PRINTCTL(FF), or PRINTCTL(HP).
Note: For compatibility with previous releases, if the LIST option value contains a period, the LIST(121) option will be set and the value specified will be used as the SYSPRINT option value. Support for this form will be removed in the next release of the assembler.
Note: For compatibility with previous releases, if the OBJECT option value contains a period, the OBJECT(OMF) option will be set and the value specified will be used as the SYSLIN option value. Support for this form will be removed in the next release of the assembler.
NOPRINTCTL specifies that the assembly listing is to be created in EBCDIC without carriage control characters. It must only be used with the EBCDIC options LINEWIDTH(number) or LINEWIDTH(V).
PRINTCTL(NL), PRINTCTL(FF), and PRINTCTL(HP) specify that the assembly listing is to be created in ASCII. The NL option indicates that blank lines will be generated to the end of each page, whereas FF indicates that the form feed character (X'0C') may be used to skip to the start of a new page. The HP option indicates that control codes for Hewlett-Packard PCL should be generated. These ASCII options must only be used with the ASCII options LINEWIDTH(CR), LINEWIDTH(LF), and LINEWIDTH(NL). See Appendix A for the interaction of the LINECOUNT and PRINTCTL(HP) options.
If the SYMNAME(XDC) option is specified, special SYM records will be produced for names longer than 8 characters. These records contain the entire symbol name and are understood by Cole Software’s XDC release 3.2 (maintenance level X32-9701D) or later.
For earlier releases of XDC, the SYMNAME(number) or SYMNAME(number,character) forms may be used. If either of these forms are specified, the assembler will compress names longer than 8 characters to fit within the limitations of the IBM SYM record format. First, any underscore characters will be removed, starting at the end of the name until the name is 8 characters long. If, after all of the underscores are removed, the name is still longer than 8 characters, it will be truncated using the SYMNAME option parameters. The first parameter must be a number from 0 to 8 or from 0 to 7 if the second parameter is specified. This parameter determines the number of leading characters of the name which will be used in the compressed name. If the second parameter is provided, it specifies a separator character to be used between the leading and trailing characters of the compressed name. It must be one of the characters valid in an assembler name (an upper or lower case letter, a digit, or a @, $, # or underscore). The remainder of the compressed name is filled with the trailing characters of the name. Since this compression can produce duplicate names in the symbolic debugging data, this option should only be used with a debugger such as XDC which can handle the duplicates.
The &D, &F, &E, and &X variables described in the Option Variables section of chapter 3 may be included in the SYSLIB parameter string. In addition, the &S variable may be used to prevent a new SYSLIB option from completely replacing the previous value for the option. The &S variable is replaced by the previous SYSLIB option value, if any. Thus, to append a new list of path patterns in front of the previous list, add the &S variable to the end of the new SYSLIB parameter.
Note: For compatibility with previous releases, if the TERM option value contains a period, the TERM(BOTH) option will be set and the value specified will be used as the SYSTERM option value. Also, the TERM option may be specified as TERMREC or abbreviated as TR. Support for these forms will be removed in the next release of the assembler.
If TEST(XDC) is specified, the SYM records produced will be compatible with the XDC debugger from Cole Software. The XDCSYMED program need not be run against the object file prior to linking. If TEST(XDC) is specified, the assembler recognizes the SYMDEL, SYMUNDEL, and SYMNODEL DSECTs as options to control the production of SYM data. Whenever a SYMDEL DSECT statement is encountered, SYM data generation is suspended. A SYMUNDEL DSECT statement decrements the count of nested SYMDEL DSECT statements and if the count reaches zero, SYM data generation is resumed. A SYMNODEL DSECT statement unconditionally sets the count to zero and resumes SYM data generation.
You may add, change, or disable the translations for any characters except for X'00' and the characters in the assembler's Standard Character Set. The unmodifyable translation table is:
00=00 20=40 23=7B 24=5B 26=50 27=7D 28=4D 29=5D 2A=5C 2B=4E 2C=6B 2D=60 2E=4B 2F=61 30=F0 31=F1 32=F2 33=F3 34=F4 35=F5 36=F6 37=F7 38=F8 39=F9 3D=7E 40=7C 41=C1 42=C2 43=C3 44=C4 45=C5 46=C6 47=C7 48=C8 49=C9 4A=D1 4B=D2 4C=D3 4D=D4 4E=D5 4F=D6 50=D7 51=D8 52=D9 53=E2 54=E3 55=E4 56=E5 57=E6 58=E7 59=E8 5A=E9 5F=6D 61=81 62=82 63=83 64=84 65=85 66=86 67=87 68=88 69=89 6A=9D 6B=92 6C=93 6D=94 6E=95 6F=96 70=97 71=98 72=99 73=A2 74=A3 75=A4 76=A5 77=A6 78=A7 79=A8 7A=A9